home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / daemons / migd.man < prev    next >
Encoding:
Text File  |  1990-12-06  |  3.7 KB  |  80 lines
  1. '\" Copyright 1990 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/daemons/migd/RCS/migd.man,v 1.2 90/12/06 14:10:16 kupfer Exp $ SPRITE (Berkeley)
  10. .so \*(]ltmac.sprite
  11. .HS MIGD daemons
  12. .BS
  13. .SH NAME
  14. migd \- Manage the migration load average and idle time database
  15. .SH SYNOPSIS
  16. .nf
  17. \fBmigd\fR \fR[\fB\-s\fR] [\fB\-D\fR \fIdebugLevel\fR] [\fB\-L\fR] [\fB\-F\fR]
  18. .fi
  19. .SH OPTIONS
  20. .IP "\fB\-s\fR" 15
  21. Run in ``silent'' mode, in which case messages about evictions are not
  22. displayed in the syslog.   The default is to print a message about
  23. each process evicted.
  24. .IP "\fB\-D\fI debugLevel\fR" 15
  25. Set the level of debugging messages.  The default is 0, which means
  26. only severe errors are printed.  Higher debugging levels produce more
  27. informational and debugging output to stderr.
  28. .IP "\fB\-L\fR" 15
  29. Log errors to files.  Rather than using the inherited stderr,
  30. \fBmigd\fR will append messages to the file \fB/sprite/admin/migd/$HOST.log\fR,
  31. and the global daemon will write to \fB/sprite/admin/migd/global-log\fR.  
  32. .IP "\fB\-F\fR" 15
  33. Don't fork; do all commands in a single process.  For debugging purposes.
  34. .BE
  35. .SH INTRODUCTION
  36. This command is used to manage the migration load average and idle
  37. time database.  A centralized daemon keeps track of all hosts and
  38. assigns idle hosts to processes upon request.  The interface to access
  39. the migration daemon is in the \fBMig\fR library.  Each host runs a
  40. copy of the migration daemon, which reports periodically to the
  41. central daemon.  The per-host daemon is responsible for sampling the
  42. load average and for detecting when foreign processes should be
  43. evicted --- i.e., migrated elsewhere --- when a user returns.  The
  44. per-host daemon also responds to \fIread\fR requests on a
  45. pseudo-device in its host-specific directory, in which case it returns
  46. a Mig_Info structure that may be used to obtain the current load
  47. averages. 
  48. .PP
  49. The global daemon is responsible for keeping track of which processes
  50. are using which hosts.  When an eviction occurs, the daemon notifies
  51. the process that had been using the host to inform it that the host is
  52. no longer available.  If a process requests more hosts than are
  53. available, then when additional hosts are available the daemon
  54. notifies the process that it may try to request more hosts.
  55. .PP
  56. If the global daemon is killed, or its host fails,
  57. one of the per-host instances of \fBmigd\fR will fork a process to
  58. become the new global daemon.  User processes will lose their
  59. connection to the global daemon.  The \fBMig\fR library is responsible
  60. for reestablishing the connection.  The new global daemon will restore
  61. its state from a checkpoint file in order to have an approximation of
  62. the last time each host was known to be up.  Hosts are assumed to be
  63. down until their migration daemons contact the new global daemon.
  64. .SH "SEE ALSO"
  65. mig, loadavg, pmake, migcmd, xload
  66. .SH FILES
  67. .IP /sprite/admin/migd/global-log
  68. The global migration daemon error log.  
  69. .IP /sprite/admin/migd/$HOST.log
  70. The error log used by host $HOST.
  71. .IP /sprite/admin/migd/pdev
  72. The pseudo-device used to communicate with the global daemon.
  73. .IP /hosts/$HOST/migd.pdev
  74. The pseudo-device used to communicate with the local daemon.
  75. .IP /sprite/admin/migd/check
  76. The file used to store the most recent information about host uptimes.
  77. .SH KEYWORDS
  78. database, eviction, foreign, idle time, load average, process migration,
  79. uptime
  80.